================================================================
 hetki 1.0.2 for macOS
 hetki by idealism
 hetki.idealism.co
================================================================

IN THIS FOLDER

   Hetki-1.0.2-macOS.pkg            the installer
   README.txt                       this file, the short version
   hetki - installation guide.pdf   from the folder to the first note
   hetki - user manual.pdf          every control and every moment
   LICENCE.txt                      the licence agreement
   THIRD-PARTY NOTICES.txt          notices for the parts hetki uses


REQUIREMENTS

   macOS 10.15 or later
   Apple Silicon or Intel, one installer for both
   Music software that loads VST®3 or Audio Unit instruments, or
      none: the standalone app plays on its own
   About 11 GB free for the sound library, on any drive
   An internet connection to download the library; after that,
      hetki plays offline

   hetki is made to fit a Mac with 8 GB of memory.

   There is no AAX version.


INSTALLING

   1. Quit your music software.
   2. Double-click "Hetki-1.0.2-macOS.pkg".
   3. Press Continue until the list of three formats appears. All
      three are ticked. Untick what you do not need:

         VST3          For most DAWs.
         Audio Unit    For Logic and GarageBand.
         Standalone    hetki on its own, no DAW.

   4. Go on and press Install. macOS asks for an administrator's name
      and password, because hetki goes into the Mac's shared folders.
   5. Open your music software and add hetki as an instrument. It is
      listed as "Hetki", made by "idealism".

   The installer is signed and notarised, so macOS opens it without
   a warning, even offline.

   The first time hetki opens, it is silent and asks for a licence.
   That is expected. Paste your licence and press "unlock", or drop
   the .hetki file onto the window. Then download the sound library
   (below). Sound arrives once the library is in.

   If your music software does not list hetki, rescan its plugins and
   check that the format it uses was ticked. Logic and GarageBand load
   only the Audio Unit. Running the installer again adds a format.


WHERE IT GOES

   /Library/Audio/Plug-Ins/VST3/Hetki.vst3
   /Library/Audio/Plug-Ins/Components/Hetki.component
   /Applications/Hetki.app

   These are the Mac's shared folders, so every user account gets
   hetki, and the installer always puts it there. Your settings and
   your own moments are kept in your own Library:

      settings   ~/Library/Application Support/Idealism/Hetki.settings
      moments    ~/Library/Idealism/Hetki/Presets/

   ~ stands for your home folder. The Library folder in it is hidden:
   in Finder, open the Go menu and hold the Option key, and Library
   appears in the list.


THE SOUND LIBRARY

   The sounds come separately, downloaded from inside hetki once a
   licence is in. Finder shows the library as about 10 GB. hetki
   counts a gigabyte as 1,024 x 1,024 x 1,024 bytes where Finder
   counts a thousand million, so for the same library its button
   says "about 9 gb" and its progress line ends "of 9.4 GB".

   1. The band under the mic faders, at the lower left of hetki's
      face, says "the sound library isn't here yet". Press
      "download the library (about 9 gb)".
   2. Choose a folder. hetki makes a folder called "Hetki Samples"
      inside it. Any drive with about 11 GB free will do.
   3. hetki checks every file as it arrives and loads the library by
      itself when the last one is in.

   Closing hetki's window in your music software does not stop the
   download. Pressing "stop", closing the project, quitting your
   music software or closing the hetki app does, and what has
   arrived is kept.

   To go on after a stop, or after "connection lost. press download",
   press download and choose the same place as before: the folder
   that holds "Hetki Samples", not "Hetki Samples" itself. The picker
   starts at your home folder each time.

   Moved the library, or copied it from another computer? Press
   "locate library…" on the band (or settings, general, sample
   library, "locate…") and choose the "Hetki Samples" folder. If it is
   on an external drive, connect the drive before hetki opens: hetki
   looks for the library only when it loads.


YOUR LICENCE

   The licence comes by email from contact@idealism.co, as text and
   as a .hetki file. The payment receipt is a separate email and does
   not hold it.

   hetki checks the licence on the Mac itself and never checks in
   with a server to play. A full licence never expires and works on
   all of your own computers. Each user account on a Mac enters it
   once. It is kept here:

      ~/Library/Application Support/Idealism/Hetki/licence.hetki

   Lost it? Search your mail for "Your hetki", or open the page you
   bought it on if you bookmarked it. The form on
   hetki.idealism.co/support sends a bought or trial licence again,
   to the address it was issued to. If none of that works, write to
   me at contact@idealism.co from the address you used.

   A trial plays everything for seven days, counted from when its
   licence goes into hetki. A trial also ends two weeks after the
   date on its licence, so put it in within a week of getting it.
   In the trial's last two days, hetki reminds you each time you
   open its window. When the trial ends, hetki goes quiet and shows
   "the week is over". Paste a bought licence there and it plays
   again, with the library and your moments as they were.

   Bought hetki with more than two days of a trial left? hetki shows
   no licence window until the reminder, so paste it then. Or rename
   the bought .hetki file to licence.hetki, put it in the folder
   above in place of the trial's, and reopen your project (or the
   app).


UPDATING

   Quit your music software and run the new installer over the old
   one. There is nothing to uninstall first. Your licence, the
   library, your settings and your own moments stay as they are, and
   projects saved with an earlier version open with the new one.

   hetki does not look for updates by itself. When there is a new
   version, an email goes out to licence holders, and
   hetki.idealism.co/download always has the latest. To stop those
   emails, reply to one and say so.


UNINSTALLING

   There is no uninstaller. Move these three to the Trash:

      /Library/Audio/Plug-Ins/VST3/Hetki.vst3
      /Library/Audio/Plug-Ins/Components/Hetki.component
      /Applications/Hetki.app

   macOS asks for an administrator's password. Then empty the Trash.

   Your licence, settings, moments and the sound library stay. To
   remove them too, delete the "Hetki Samples" folder and the
   licence, settings and moments paths above.


HELP

   hetki.idealism.co/support answers the common questions, and
   hetki.idealism.co/guide goes from the first click to the first
   note.

   Or write to me at contact@idealism.co. Tell me which macOS
   version, which music software (and whether you use the VST3, the
   Audio Unit or the app) and which version of hetki (the about page
   in settings shows it). For a licence or an order, add the order
   number.


   Recorded at Greystoke Studio, London. Engineered by Andy Whitmore.

   VST is a registered trademark of Steinberg Media Technologies GmbH.
   Audio Units is a trademark of Apple Inc.

   See LICENCE.txt for the licence agreement.
